Chuyển tới nội dung chính

Cuộn phần tử giao diện hoặc trang hiện tại (ui_element.scroll)

Hàm này khả dụng trong các phiên bản sau 20260507

Khai báo​

trạng thái, thông tin hoặc thông báo lỗi = ui_element.scroll(hướng [, tùy chọn ])
trạng thái, thông tin hoặc thông báo lỗi = ui_element.scroll(bộ chọn hoặc phần tử, hướng [, tùy chọn ])

Tham số​

  • bộ chọn hoặc phần tử
    Không bắt buộc, bảng. Một bộ chọn, phần tử do truy vấn trả về hoặc bảng tọa độ { x = X, y = Y }.
  • hướng
    Chuỗi. Các giá trị được hỗ trợ: "down", "up", "left", "right", "top", "bottom".
  • tùy chọn
    Không bắt buộc, bảng. Dùng point, x hoặc y để chọn điểm tương tác; dùng steps làm tham số bước.

Giá trị trả về​

  • trạng thái
    Boolean. true khi thành công, nil khi thất bại.
  • thông tin hoặc thông báo lỗi
    Bảng khi thành công, chuỗi lý do thất bại khi thất bại.

Mô tả​

Khi không có bộ chọn, API này thử cuộn trang hiện tại. Khi có bộ chọn, API thử cuộn vùng có thể cuộn chứa mục tiêu. Nếu cần cuộn nhiều trang, hãy gọi API trong vòng lặp Lua và tự kiểm tra thay đổi của trang.

Ví dụ​

local ui_element = require("ui_element")

ui_element.scroll("down", {
point = { x = 200, y = 700 },
})

ui_element.scroll({
text_contains = "Danh sách",
}, "up")